home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / programr / cppsum.zip / CPPSUM.H < prev    next >
C/C++ Source or Header  |  1994-06-18  |  5KB  |  128 lines
  1. #ifndef _CPPSUM_H_
  2. #define _CPPSUM_H_
  3. /***************************************************************************
  4. *
  5. * DLL functions to get summary info from OLE 2.0 document files.
  6. *
  7. *     Copyright ⌐ 1994 Frank F Ramos, All Rights Reserved
  8. *     Send problem reports and comments to 72202.2574@compuserve.com
  9. *            
  10. * Compile using CPPSUM.H
  11. * Link using CPPSUM.LIB
  12. * CPPSUM.DLL should be placed in \WINDOWS\SYSTEM.
  13. * 
  14. * Example of usage:
  15. *     WORD   wInitStatus;
  16. *     HANDLE hSumInfo;
  17. *     char   szTemp[256];
  18. *     LPSTR  szFilePath;
  19. *     WORD   yr, mon, day, hr, min, sec;
  20. *     if (wInitStatus = SumInfoInit()) {
  21. *        ... loop to process files ...
  22. *           szFilePath = ...
  23. *           if (hSumInfo = SumInfoOpenFile(szFilePath)) {
  24. *              if (SumInfoGetString(hSumInfo, PID_TITLE, szTemp, 256)) {
  25. *                 ... do something with szTemp ...
  26. *              }
  27. *              if (SumInfoGetTime(hSumInfo, PID_LASTSAVED, 
  28. *                                 &yr, &mon, &day, &hr, &min, &sec)) {
  29. *                 ... do something with time ...
  30. *              }
  31. *              ...
  32. *              SumInfoCloseFile(hSumInfo);
  33. *           }
  34. *        }
  35. *        SumInfoUninit(wInitStatus);
  36. *     }
  37. *
  38. * Reasons for failure:
  39. *     SumInfoInit:     out of memory
  40. *     SumInfoOpenFile: out of memory
  41. *                      file not found
  42. *                      file is not an OLE 2.0 structured storage file
  43. *                      file does not contain OLE 2.0 summary info
  44. *                      OLE 2.0 summary info is incorrectly formatted
  45. *     SumInfoGet...  : specified property type is not available
  46. *     
  47. * Change log:
  48. * V1.4 94/06/18 Documentation changes only
  49. * V1.3 94/06/06 Change validity checking, because Excel 5.0 files
  50. *                  are slightly invalid
  51. * V1.2 94/03/01 Change STGM_SHARE_DENY_WRITE to STGM_SHARE_DENY_NONE, so
  52. *                  info can be obtained for files currently open in WinWord.
  53. * V1.1 94/01/22 Add wInitStatus parameter to SumInfoInit and SumInfoUninit,
  54. *                  to account for case where CoInitialize already called for  
  55. *                  application.
  56. *               Ensure SumInfoGetString returns zero terminated string.
  57. *               Fix minor typos in documentation.
  58. * V1.0 94/01/20 Initial version.
  59. **************************************************************************/
  60.  
  61.    /* String properties */
  62. #define PID_TITLE          0X00000002
  63. #define PID_SUBJECT        0X00000003
  64. #define PID_AUTHOR         0X00000004
  65. #define PID_KEYWORDS       0X00000005
  66. #define PID_COMMENTS       0X00000006
  67. #define PID_TEMPLATE       0X00000007
  68. #define PID_LASTAUTHOR     0X00000008
  69. #define PID_REVNUMBER      0X00000009
  70. #define PID_APPNAME        0X00000012
  71.  
  72.    /* Time properties */
  73. #define PID_TOTAL_EDITTIME 0X0000000A
  74. #define PID_LASTPRINTED    0X0000000B
  75. #define PID_CREATED        0X0000000C
  76. #define PID_LASTSAVED      0X0000000D
  77.  
  78.    /* Long properties */
  79. #define PID_PAGECOUNT      0X0000000E
  80. #define PID_WORDCOUNT      0X0000000F
  81. #define PID_CHARCOUNT      0X00000010
  82. #define PID_SECURITY       0X00000013
  83.  
  84.    /* bit masks for security long */
  85. #define AllSecurityFlagsEqNone         0
  86. #define fSecurityPassworded            1
  87. #define fSecurityRORecommended         2
  88. #define fSecurityRO                    4
  89. #define fSecurityLockedForAnnotations  8
  90.  
  91. #ifdef __cplusplus
  92. extern "C" {
  93. #endif
  94.  
  95. WORD FAR PASCAL SumInfoInit(); /* return value of non-zero indicates success 
  96.                                   return value must be passed to SumInfoUninit */
  97.  
  98. HANDLE FAR PASCAL SumInfoOpenFile(LPSTR      szPath);  /*in : file path  */
  99.                                  
  100. BOOL FAR PASCAL SumInfoGetString(HANDLE      hSumInfo, /*in : handle     */
  101.                                  DWORD       pid,      /*in : property ID*/
  102.                                  LPSTR       lpBuf,    /*out: string val */
  103.                                  int         cbBuf);   /*in : lpStr size */
  104.                                  
  105. BOOL FAR PASCAL SumInfoGetLong  (HANDLE      hSumInfo, /*in : handle     */     
  106.                                  DWORD       pid,      /*in : property ID*/
  107.                                  LPLONG      lpLong);  /*out: long val   */
  108.                                  
  109. BOOL FAR PASCAL SumInfoGetTime  (HANDLE      hSumInfo, /*in : handle     */
  110.                                  DWORD       pid,      /*in : property ID*/
  111.                                  LPWORD      lpYear,   /*out: 1980-9999  */
  112.                                  LPWORD      lpMonth,  /*out: 1-12       */
  113.                                  LPWORD      lpDay,    /*out: 1-31       */
  114.                                  LPWORD      lpHour,   /*out: 0-23       */
  115.                                  LPWORD      lpMin,    /*out: 0-59       */
  116.                                  LPWORD      lpSec);   /*out: 0-59       */
  117.                                  
  118. void FAR PASCAL SumInfoCloseFile(HANDLE     hSumInfo); /*in : handle     */
  119.  
  120. void FAR PASCAL SumInfoUninit   (WORD     wInitStatus);/*in : status from SumInfoInit*/
  121.  
  122. #ifdef __cplusplus
  123. }
  124. #endif 
  125.  
  126. #endif /* _CPPSUM_H_ */
  127.  
  128.